<!DOCTYPE html>
<html>

<head>
  <title>Quarkus - Amazon S3 Client</title>
  <script id="adobe_dtm" src="https://www.redhat.com/dtm.js" type="text/javascript"></script>
  <script src="/assets/javascript/highlight.pack.js" type="text/javascript"></script>
  <META HTTP-EQUIV='Content-Security-Policy' CONTENT="default-src 'none'; script-src 'self' 'unsafe-eval' 'sha256-ANpuoVzuSex6VhqpYgsG25OHWVA1I+F6aGU04LoI+5s=' 'sha256-ipy9P/3rZZW06mTLAR0EnXvxSNcnfSDPLDuh3kzbB1w=' js.bizographics.com https://www.redhat.com assets.adobedtm.com jsonip.com https://ajax.googleapis.com https://www.googletagmanager.com https://www.google-analytics.com https://use.fontawesome.com; style-src 'self' https://fonts.googleapis.com https://use.fontawesome.com; img-src 'self' *; media-src 'self' ; frame-src https://www.googletagmanager.com https://www.youtube.com; frame-ancestors 'none'; base-uri 'none'; object-src 'none'; form-action 'none'; font-src 'self' https://use.fontawesome.com https://fonts.gstatic.com;">
  <META HTTP-EQUIV='X-Frame-Options' CONTENT="DENY">
  <META HTTP-EQUIV='X-XSS-Protection' CONTENT="1; mode=block">
  <META HTTP-EQUIV='X-Content-Type-Options' CONTENT="nosniff">
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="description" content="Quarkus: Supersonic Subatomic Java">
  <meta name="twitter:card" content="summary_large_image">
  <meta name="twitter:site" content="@QuarkusIO"> 
  <meta name="twitter:creator" content="@QuarkusIO">
  <meta property="og:url" content="https://quarkus.io/guides/amazon-s3" />
  <meta property="og:title" content="Quarkus - Amazon S3 Client" />
  <meta property="og:description" content="Quarkus: Supersonic Subatomic Java" />
  <meta property="og:image" content="/assets/images/quarkus_card.png" />
  <link rel="canonical" href="https://quarkus.io/guides/amazon-s3">
  <link rel="shortcut icon" type="image/png" href="/favicon.ico" >
  <link rel="stylesheet" href="https://quarkus.io/guides/stylesheet/config.css" />
  <link rel="stylesheet" href="/assets/css/main.css" />
  <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.1.0/css/all.css" integrity="sha384-lKuwvrZot6UHsBSfcMvOkWwlCMgc0TaWr+30HWe3a4ltaBwTZhyTEggF5tJv8tbt" crossorigin="anonymous">
  <link rel="alternate" type="application/rss+xml"  href="https://quarkus.io/feed.xml" title="Quarkus">
  <script src="https://quarkus.io/assets/javascript/goan.js" type="text/javascript"></script>
  <script src="https://quarkus.io/assets/javascript/hl.js" type="text/javascript"></script>
</head>

<body class="guides">
  <!-- Google Tag Manager (noscript) -->
  <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-NJWS5L"
  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
  <!-- End Google Tag Manager (noscript) -->

  <div class="nav-wrapper">
  <div class="grid-wrapper">
    <div class="width-12-12">
      <input type="checkbox" id="checkbox" />
      <nav id="main-nav" class="main-nav">
  <div class="container">
    <div class="logo-wrapper">
      
        <a href="/"><img src="/assets/images/quarkus_logo_horizontal_rgb_600px_reverse.png" class="project-logo" title="Quarkus"></a>
      
    </div>
    <label class="nav-toggle" for="checkbox">
      <i class="fa fa-bars"></i>
    </label>
    <div id="menu" class="menu">
      <span>
        <a href="/get-started/" class="">Get Started</a>
      </span>
      <span>
        <a href="/guides/" class="active">Guides</a>
      </span>
      <span>
        <a href="/community/" class="">Community</a>
      </span>
      <span>
        <a href="/support/" class="">Support</a>
      </span>
      <span>
        <a href="/blog/" class="">Blog</a>
      </span>
      <span>
        <a href="https://code.quarkus.io" class="button-cta secondary white">Start Coding</a>
      </span>
    </div>
  </div>
      </nav>
    </div>
  </div>
</div>

  <div class="content">
    <div class="guide">
  <div class="width-12-12">
    <h1 class="text-caps">Quarkus - Amazon S3 Client</h1>
    <div class="hide-mobile toc"><ul class="sectlevel1">
<li><a href="#prerequisites">Prerequisites</a>
<ul class="sectlevel2">
<li><a href="#provision-s3-locally">Provision S3 locally</a></li>
<li><a href="#create-a-s3-bucket">Create a S3 bucket</a></li>
</ul>
</li>
<li><a href="#solution">Solution</a></li>
<li><a href="#creating-the-maven-project">Creating the Maven project</a></li>
<li><a href="#setting-up-the-model">Setting up the model</a></li>
<li><a href="#create-jax-rs-resource">Create JAX-RS resource</a></li>
<li><a href="#configuring-s3-clients">Configuring S3 clients</a></li>
<li><a href="#creating-a-frontend">Creating a frontend</a></li>
<li><a href="#next-steps">Next steps</a>
<ul class="sectlevel2">
<li><a href="#packaging">Packaging</a></li>
<li><a href="#going-asynchronous">Going asynchronous</a></li>
</ul>
</li>
<li><a href="#configuration-reference">Configuration Reference</a></li>
</ul></div>
    <div>
      <div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>Amazon S3 is an object storage service. It can be employed to store any type of object which allows for uses like storage for Internet applications,
backup and recovery, disaster recovery, data archives, data lakes for analytics, any hybrid cloud storage.
This extension provides functionality that allows the client to communicate with the service when running in Quarkus.
You can find more information about S3 at <a href="https://aws.amazon.com/s3/">the Amazon S3 website</a>.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
The S3 extension is based on <a href="https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/welcome.html">AWS Java SDK 2.x</a>.
It&#8217;s a major rewrite of the 1.x code base that offers two programming models (Blocking &amp; Async).
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>The Quarkus extension supports two programming models:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Blocking access using URL Connection HTTP client (by default) or the Apache HTTP Client</p>
</li>
<li>
<p><a href="https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/basics-async.html">Asynchronous programming</a> based on JDK&#8217;s <code>CompletableFuture</code> objects and the Netty HTTP client.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>In this guide, we see how you can get your REST services to use S3 locally and on AWS.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="prerequisites"><a class="anchor" href="#prerequisites"></a>Prerequisites</h2>
<div class="sectionbody">
<div class="paragraph">
<p>To complete this guide, you need:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>JDK 1.8+ installed with <code>JAVA_HOME</code> configured appropriately</p>
</li>
<li>
<p>an IDE</p>
</li>
<li>
<p>Apache Maven 3.5.3+</p>
</li>
<li>
<p><a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html">AWS Command line interface</a></p>
</li>
<li>
<p>An AWS Account to access the S3 service. Before you can use the AWS SDKs with Amazon S3, you must get an AWS access key ID and secret access key.</p>
</li>
<li>
<p>Optionally, Docker for your system to run S3 locally for testing purposes</p>
</li>
</ul>
</div>
<div class="sect2">
<h3 id="provision-s3-locally"><a class="anchor" href="#provision-s3-locally"></a>Provision S3 locally</h3>
<div class="paragraph">
<p>The easiest way to start working with S3 is to run a local instance as a container.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">docker run -it --publish 8008:4572 -e SERVICES=s3 -e START_WEB=0 localstack/localstack</code></pre>
</div>
</div>
<div class="paragraph">
<p>This starts a S3 instance that is accessible on port <code>8008</code>.</p>
</div>
<div class="paragraph">
<p>Create an AWS profile for your local instance using AWS CLI:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">$ aws configure --profile localstack
AWS Access Key ID [None]: test-key
AWS Secret Access Key [None]: test-secret
Default region name [None]: us-east-1
Default output format [None]:</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="create-a-s3-bucket"><a class="anchor" href="#create-a-s3-bucket"></a>Create a S3 bucket</h3>
<div class="paragraph">
<p>Create a S3 bucket using AWS CLI</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">aws s3 mb s3://quarkus.s3.quickstart --profile localstack --endpoint-url=http://localhost:8008</code></pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="solution"><a class="anchor" href="#solution"></a>Solution</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The application built here allows to manage files stored in Amazon S3.</p>
</div>
<div class="paragraph">
<p>We recommend that you follow the instructions in the next sections and create the application step by step.
However, you can go right to the completed example.</p>
</div>
<div class="paragraph">
<p>Clone the Git repository: <code>git clone <a href="https://github.com/quarkusio/quarkus-quickstarts.git" class="bare">https://github.com/quarkusio/quarkus-quickstarts.git</a></code>, or download an <a href="https://github.com/quarkusio/quarkus-quickstarts/archive/master.zip">archive</a>.</p>
</div>
<div class="paragraph">
<p>The solution is located in the <code>amazon-s3-quickstart</code> <a href="https://github.com/quarkusio/quarkus-quickstarts/tree/master/amazon-s3-quickstart">directory</a>.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="creating-the-maven-project"><a class="anchor" href="#creating-the-maven-project"></a>Creating the Maven project</h2>
<div class="sectionbody">
<div class="paragraph">
<p>First, we need a new project. Create a new project with the following command:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">mvn io.quarkus:quarkus-maven-plugin:1.7.0.Final:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=amazon-s3-quickstart \
    -DclassName="org.acme.s3.S3SyncClientResource" \
    -Dpath="/s3" \
    -Dextensions="resteasy-jsonb,amazon-s3"
cd amazon-s3-quickstart</code></pre>
</div>
</div>
<div class="paragraph">
<p>This command generates a Maven structure importing the RESTEasy/JAX-RS and S3 Client extensions.
After this, the <code>amazon-s3</code> extension has been added to your <code>pom.xml</code>.</p>
</div>
<div class="paragraph">
<p>Then, we&#8217;ll add the following dependency to support <code>multipart/form-data</code> requests:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;dependency&gt;
    &lt;groupId&gt;org.jboss.resteasy&lt;/groupId&gt;
    &lt;artifactId&gt;resteasy-multipart-provider&lt;/artifactId&gt;
&lt;/dependency&gt;</code></pre>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="setting-up-the-model"><a class="anchor" href="#setting-up-the-model"></a>Setting up the model</h2>
<div class="sectionbody">
<div class="paragraph">
<p>In this example, we will create an application to manage a list of files. The example application will demonstrate the two programming models supported by the extension.</p>
</div>
<div class="paragraph">
<p>Because the primary goal of our application is to upload a file into the S3 bucket, we need to setup the model we will be using to define the <code>multipart/form-data</code> payload,
in the form of a <code>MultipartBody</code> POJO.</p>
</div>
<div class="paragraph">
<p>Create a <code>org.acme.s3.FormData</code> class as follows:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="java" class="language-java hljs">package org.acme.s3;

import java.io.InputStream;

import javax.ws.rs.FormParam;
import javax.ws.rs.core.MediaType;

import org.jboss.resteasy.annotations.providers.multipart.PartType;

public class FormData {

    @FormParam("file")
    @PartType(MediaType.APPLICATION_OCTET_STREAM)
    public InputStream data;

    @FormParam("filename")
    @PartType(MediaType.TEXT_PLAIN)
    public String fileName;

    @FormParam("mimetype")
    @PartType(MediaType.TEXT_PLAIN)
    public String mimeType;

}</code></pre>
</div>
</div>
<div class="paragraph">
<p>The class defines three fields:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>data</code> that fill capture stream of uploaded bytes from the client</p>
</li>
<li>
<p><code>fileName</code> that captures a filename as provided by the submited form</p>
</li>
<li>
<p><code>mimeType</code> content type of the uploaded file</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>In the second step let&#8217;s create a bean that will represent a file in a Amazon S3 bucket as follows:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="java" class="language-java hljs">package org.acme.s3;

import software.amazon.awssdk.services.s3.model.S3Object;

public class FileObject {
    private String objectKey;

    private Long size;

    public FileObject() {
    }

    public static FileObject from(S3Object s3Object) {
        FileObject file = new FileObject();
        if (s3Object != null) {
            file.setObjectKey(s3Object.key());
            file.setSize(s3Object.size());
        }
        return file;
    }

    public String getObjectKey() {
        return objectKey;
    }

    public Long getSize() {
        return size;
    }

    public FileObject setObjectKey(String objectKey) {
        this.objectKey = objectKey;
        return this;
    }

    public FileObject setSize(Long size) {
        this.size = size;
        return this;
    }
}</code></pre>
</div>
</div>
<div class="paragraph">
<p>Nothing fancy. One important thing to note is that having a default constructor is required by the JSON serialization layer. The static <code>from</code> method creates a bean based on the <code>S3Object</code>
object provided by the S3 client response when listing all the objects in a bucket.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="create-jax-rs-resource"><a class="anchor" href="#create-jax-rs-resource"></a>Create JAX-RS resource</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Now create a <code>org.acme.s3.CommonResource</code> that will consist of methods to prepare S3 request to get object from a S3 bucket, or to put file into a S3 bucket.
Note a configuration property <code>bucket.name</code> is defined here as the request method required name of the S3 bucket.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="java" class="language-java hljs">package org.acme.s3;

import java.io.File;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.StandardCopyOption;
import java.util.Date;
import java.util.UUID;

import org.eclipse.microprofile.config.inject.ConfigProperty;

import software.amazon.awssdk.services.s3.model.GetObjectRequest;
import software.amazon.awssdk.services.s3.model.PutObjectRequest;

abstract public class CommonResource {
    private final static String TEMP_DIR = System.getProperty("java.io.tmpdir");

    @ConfigProperty(name = "bucket.name")
    String bucketName;

    protected PutObjectRequest buildPutRequest(FormData formData) {
        return PutObjectRequest.builder()
                .bucket(bucketName)
                .key(formData.fileName)
                .contentType(formData.mimeType)
                .build();
    }

    protected GetObjectRequest buildGetRequest(String objectKey) {
        return GetObjectRequest.builder()
                .bucket(bucketName)
                .key(objectKey)
                .build();
    }

    protected File tempFilePath() {
        return new File(TEMP_DIR, new StringBuilder().append("s3AsyncDownloadedTemp")
                .append((new Date()).getTime()).append(UUID.randomUUID())
                .append(".").append(".tmp").toString());
    }

    protected File uploadToTemp(InputStream data) {
        File tempPath;
        try {
            tempPath = File.createTempFile("uploadS3Tmp", ".tmp");
            Files.copy(data, tempPath.toPath(), StandardCopyOption.REPLACE_EXISTING);
        } catch (Exception ex) {
            throw new RuntimeException(ex);
        }

        return tempPath;
    }
}</code></pre>
</div>
</div>
<div class="paragraph">
<p>Then, create a <code>org.acme.s3.S3SyncClientResource</code> that will provides an API to upload/download files as well as to list all the files in a bucket.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="java" class="language-java hljs">package org.acme.s3;

import java.io.ByteArrayOutputStream;
import java.util.Comparator;
import java.util.List;
import java.util.stream.Collectors;

import javax.inject.Inject;
import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.Response.ResponseBuilder;
import javax.ws.rs.core.Response.Status;
import javax.ws.rs.core.StreamingOutput;

import org.jboss.resteasy.annotations.jaxrs.PathParam;
import org.jboss.resteasy.annotations.providers.multipart.MultipartForm;

import software.amazon.awssdk.core.sync.RequestBody;
import software.amazon.awssdk.core.sync.ResponseTransformer;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.GetObjectResponse;
import software.amazon.awssdk.services.s3.model.ListObjectsRequest;
import software.amazon.awssdk.services.s3.model.PutObjectResponse;
import software.amazon.awssdk.services.s3.model.S3Object;

@Path("/s3")
public class S3SyncClientResource extends CommonResource {
    @Inject
    S3Client s3;

    @POST
    @Path("upload")
    @Consumes(MediaType.MULTIPART_FORM_DATA)
    public Response uploadFile(@MultipartForm FormData formData) throws Exception {

        if (formData.fileName == null || formData.fileName.isEmpty()) {
            return Response.status(Status.BAD_REQUEST).build();
        }

        if (formData.mimeType == null || formData.mimeType.isEmpty()) {
            return Response.status(Status.BAD_REQUEST).build();
        }

        PutObjectResponse putResponse = s3.putObject(buildPutRequest(formData),
                RequestBody.fromFile(uploadToTemp(formData.data)));
        if (putResponse != null) {
            return Response.ok().status(Status.CREATED).build();
        } else {
            return Response.serverError().build();
        }
    }

    @GET
    @Path("download/{objectKey}")
    @Produces(MediaType.APPLICATION_OCTET_STREAM)
    public Response downloadFile(@PathParam("objectKey") String objectKey) {
        ByteArrayOutputStream baos = new ByteArrayOutputStream();
        GetObjectResponse object = s3.getObject(buildGetRequest(objectKey), ResponseTransformer.toOutputStream(baos));

        ResponseBuilder response = Response.ok((StreamingOutput) output -&gt; baos.writeTo(output));
        response.header("Content-Disposition", "attachment;filename=" + objectKey);
        response.header("Content-Type", object.contentType());
        return response.build();
    }

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public List&lt;FileObject&gt; listFiles() {
        ListObjectsRequest listRequest = ListObjectsRequest.builder().bucket(bucketName).build();

        //HEAD S3 objects to get metadata
        return s3.listObjects(listRequest).contents().stream().sorted(Comparator.comparing(S3Object::lastModified).reversed())
                .map(FileObject::from).collect(Collectors.toList());
    }
}</code></pre>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="configuring-s3-clients"><a class="anchor" href="#configuring-s3-clients"></a>Configuring S3 clients</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Both S3 clients (sync and async) are configurable via the <code>application.properties</code> file that can be provided in the <code>src/main/resources</code> directory.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
You need to add to the classpath a proper implementation of the sync client. By default the extension uses the URL connection HTTP client, so
add a URL connection client dependency to the <code>pom.xml</code> file:
</td>
</tr>
</table>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;dependency&gt;
    &lt;groupId&gt;software.amazon.awssdk&lt;/groupId&gt;
    &lt;artifactId&gt;url-connection-client&lt;/artifactId&gt;
&lt;/dependency&gt;</code></pre>
</div>
</div>
<div class="paragraph">
<p>If you want to use Apache HTTP client instead, configure it as follows:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="properties" class="language-properties hljs">quarkus.s3.sync-client.type=apache</code></pre>
</div>
</div>
<div class="paragraph">
<p>And add following dependency to the application <code>pom.xml</code>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;dependency&gt;
    &lt;groupId&gt;software.amazon.awssdk&lt;/groupId&gt;
    &lt;artifactId&gt;apache-client&lt;/artifactId&gt;
&lt;/dependency&gt;</code></pre>
</div>
</div>
<div class="paragraph">
<p>For asynchronous client refer to <a href="#going-asynchronous">Going asynchronous</a> for more information.</p>
</div>
<div class="paragraph">
<p>If you&#8217;re going to use a local S3 instance, configure it as follows:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="properties" class="language-properties hljs">quarkus.s3.endpoint-override=http://localhost:8008

quarkus.s3.aws.region=us-east-1
quarkus.s3.aws.credentials.type=static
quarkus.s3.aws.credentials.static-provider.access-key-id=test-key
quarkus.s3.aws.credentials.static-provider.secret-access-key=test-secret

bucket.name=quarkus.s3.quickstart</code></pre>
</div>
</div>
<div class="ulist">
<ul>
<li>
<p><code>quarkus.s3.aws.region</code> - It&#8217;s required by the client, but since you&#8217;re using a local S3 instance you can pick any valid AWS region.</p>
</li>
<li>
<p><code>quarkus.s3.aws.credentials.type</code> - Set <code>static</code> credentials provider with any values for <code>access-key-id</code> and <code>secret-access-key</code></p>
</li>
<li>
<p><code>quarkus.s3.endpoint-override</code> - Override the S3 client to use a local instance instead of an AWS service</p>
</li>
<li>
<p><code>bucket.name</code> - Name of the S3 bucket</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If you want to work with an AWS account, you&#8217;d need to set it with:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="properties" class="language-properties hljs">bucket.name=&lt;your-bucket-name&gt;

quarkus.s3.aws.region=&lt;YOUR_REGION&gt;
quarkus.s3.aws.credentials.type=default</code></pre>
</div>
</div>
<div class="ulist">
<ul>
<li>
<p><code>bucket.name</code> - name of the S3 bucket on your AWS account.</p>
</li>
<li>
<p><code>quarkus.s3.aws.region</code> you should set it to the region where your S3 bucket was created,</p>
</li>
<li>
<p><code>quarkus.s3.aws.credentials.type</code> - use the <code>default</code> credentials provider chain that looks for credentials in this order:</p>
<div class="ulist">
<ul>
<li>
<p>Java System Properties - <code>aws.accessKeyId</code> and <code>aws.secretAccessKey</code></p>
</li>
<li>
<p>Environment Variables - <code>AWS_ACCESS_KEY_ID</code> and <code>AWS_SECRET_ACCESS_KEY</code></p>
</li>
<li>
<p>Credential profiles file at the default location (<code>~/.aws/credentials</code>) shared by all AWS SDKs and the AWS CLI</p>
</li>
<li>
<p>Credentials delivered through the Amazon ECS if the <code>AWS_CONTAINER_CREDENTIALS_RELATIVE_URI</code> environment variable is set and the security manager has permission to access the variable,</p>
</li>
<li>
<p>Instance profile credentials delivered through the Amazon EC2 metadata service</p>
</li>
</ul>
</div>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="creating-a-frontend"><a class="anchor" href="#creating-a-frontend"></a>Creating a frontend</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Now let&#8217;s add a simple web page to interact with our <code>S3SyncClientResource</code>.
Quarkus automatically serves static resources located under the <code>META-INF/resources</code> directory.
In the <code>src/main/resources/META-INF/resources</code> directory, add a <code>s3.html</code> file with the content from this <a href="https://github.com/quarkusio/quarkus-quickstarts/blob/master/amazon-s3-quickstart/src/main/resources/META-INF/resources/s3.html">s3.html</a> file in it.</p>
</div>
<div class="paragraph">
<p>You can now interact with your REST service:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>start Quarkus with <code>./mvnw compile quarkus:dev</code></p>
</li>
<li>
<p>open a browser to <code><a href="http://localhost:8080/s3.html" class="bare">http://localhost:8080/s3.html</a></code></p>
</li>
<li>
<p>upload new file to the current S3 bucket via the form and see the list of files in the bucket</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="next-steps"><a class="anchor" href="#next-steps"></a>Next steps</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="packaging"><a class="anchor" href="#packaging"></a>Packaging</h3>
<div class="paragraph">
<p>Packaging your application is as simple as <code>./mvnw clean package</code>.
It can be run with <code>java -jar target/amazon-s3-quickstart-1.0-SNAPSHOT-runner.jar</code>.</p>
</div>
<div class="paragraph">
<p>With GraalVM installed, you can also create a native executable binary: <code>./mvnw clean package -Dnative</code>.
Depending on your system, that will take some time.</p>
</div>
</div>
<div class="sect2">
<h3 id="going-asynchronous"><a class="anchor" href="#going-asynchronous"></a>Going asynchronous</h3>
<div class="paragraph">
<p>Thanks to the AWS SDK v2.x used by the Quarkus extension, you can use the asynchronous programming model out of the box.</p>
</div>
<div class="paragraph">
<p>Create a <code>org.acme.s3.S3AsyncClientResource</code> that will be similar to our <code>S3SyncClientResource</code> but using an asynchronous programming model.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="java" class="language-java hljs">package org.acme.s3;

import java.io.File;
import java.util.Comparator;
import java.util.List;
import java.util.stream.Collectors;

import javax.inject.Inject;
import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.Response.Status;

import org.jboss.resteasy.annotations.jaxrs.PathParam;
import org.jboss.resteasy.annotations.providers.multipart.MultipartForm;

import io.smallrye.mutiny.Uni;
import software.amazon.awssdk.core.async.AsyncRequestBody;
import software.amazon.awssdk.core.async.AsyncResponseTransformer;
import software.amazon.awssdk.services.s3.S3AsyncClient;
import software.amazon.awssdk.services.s3.model.ListObjectsRequest;
import software.amazon.awssdk.services.s3.model.ListObjectsResponse;
import software.amazon.awssdk.services.s3.model.S3Object;

@Path("/async-s3")
public class S3AsyncClientResource extends CommonResource {
    @Inject
    S3AsyncClient s3;

    @POST
    @Path("upload")
    @Consumes(MediaType.MULTIPART_FORM_DATA)
    public Uni&lt;Response&gt; uploadFile(@MultipartForm FormData formData) throws Exception {

        if (formData.fileName == null || formData.fileName.isEmpty()) {
            return Uni.createFrom().item(Response.status(Status.BAD_REQUEST).build());
        }

        if (formData.mimeType == null || formData.mimeType.isEmpty()) {
            return Uni.createFrom().item(Response.status(Status.BAD_REQUEST).build());
        }

        return Uni.createFrom()
                .completionStage(() -&gt; {
                    return s3.putObject(buildPutRequest(formData), AsyncRequestBody.fromFile(uploadToTemp(formData.data)));
                })
                .onItem().ignore().andSwitchTo(Uni.createFrom().item(Response.created(null).build()))
                .onFailure().recoverWithItem(th -&gt; {
                    th.printStackTrace();
                    return Response.serverError().build();
                });
    }

    @GET
    @Path("download/{objectKey}")
    @Produces(MediaType.APPLICATION_OCTET_STREAM)
    public Uni&lt;Response&gt; downloadFile(@PathParam("objectKey") String objectKey) throws Exception {
        File tempFile = tempFilePath();

        return Uni.createFrom()
                .completionStage(() -&gt; s3.getObject(buildGetRequest(objectKey), AsyncResponseTransformer.toFile(tempFile)))
                .onItem()
                .apply(object -&gt; Response.ok(tempFile)
                        .header("Content-Disposition", "attachment;filename=" + objectKey)
                        .header("Content-Type", object.contentType()).build());
    }

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public Uni&lt;List&lt;FileObject&gt;&gt; listFiles() {
        ListObjectsRequest listRequest = ListObjectsRequest.builder()
                .bucket(bucketName)
                .build();

        return Uni.createFrom().completionStage(() -&gt; s3.listObjects(listRequest))
                .onItem().transform(result -&gt; toFileItems(result));
    }

    private List&lt;FileObject&gt; toFileItems(ListObjectsResponse objects) {
        return objects.contents().stream()
                .sorted(Comparator.comparing(S3Object::lastModified).reversed())
                .map(FileObject::from).collect(Collectors.toList());
    }
}</code></pre>
</div>
</div>
<div class="paragraph">
<p>You need the RESTEasy Mutiny support for asynchronous programming. Add the dependency to the <code>pom.xml</code>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;dependency&gt;
    &lt;groupId&gt;io.quarkus&lt;/groupId&gt;
    &lt;artifactId&gt;quarkus-resteasy-mutiny&lt;/artifactId&gt;
&lt;/dependency&gt;</code></pre>
</div>
</div>
<div class="paragraph">
<p>Or you can alternatively run this command in your project base directory:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="bash" class="language-bash hljs">./mvnw quarkus:add-extension -Dextensions="resteasy-mutiny"</code></pre>
</div>
</div>
<div class="paragraph">
<p>And add the Netty HTTP client dependency to the <code>pom.xml</code>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;dependency&gt;
    &lt;groupId&gt;software.amazon.awssdk&lt;/groupId&gt;
    &lt;artifactId&gt;netty-nio-client&lt;/artifactId&gt;
&lt;/dependency&gt;</code></pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="configuration-reference"><a class="anchor" href="#configuration-reference"></a>Configuration Reference</h2>
<div class="sectionbody">
<div class="paragraph configuration-legend">
<p><span class="icon"><i class="fa fa-lock" title="Fixed at build time"></i></span> Configuration property fixed at build time - All other configuration properties are overridable at runtime</p>
</div>
<table class="tableblock frame-all grid-all stretch configuration-reference searchable">
<colgroup>
<col style="width: 80%;">
<col style="width: 10%;">
<col style="width: 10%;">
</colgroup>
<tbody>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_configuration"></a><a href="#quarkus-amazon-s3_configuration">Configuration property</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="icon"><i class="fa fa-lock" title="Fixed at build time"></i></span> <a id="quarkus-amazon-s3_quarkus.s3.interceptors"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.interceptors">quarkus.s3.interceptors</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>List of execution interceptors that will have access to read and modify the request and response objects as they are processed by the AWS SDK.
 The list should consists of class names which implements <code>software.amazon.awssdk.core.interceptor.ExecutionInterceptor</code> interface.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">list of class name</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="icon"><i class="fa fa-lock" title="Fixed at build time"></i></span> <a id="quarkus-amazon-s3_quarkus.s3.sync-client.type"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.type">quarkus.s3.sync-client.type</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Type of the sync HTTP client implementation</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>url</code>, <code>apache</code></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>url</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.accelerate-mode"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.accelerate-mode">quarkus.s3.accelerate-mode</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable using the accelerate endpoint when accessing S3.
 Accelerate endpoints allow faster transfer of objects by using Amazon CloudFront&#8217;s globally distributed edge locations.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.checksum-validation"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.checksum-validation">quarkus.s3.checksum-validation</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable doing a validation of the checksum of an object stored in S3.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.chunked-encoding"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.chunked-encoding">quarkus.s3.chunked-encoding</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable using chunked encoding when signing the request payload for <code>software.amazon.awssdk.services.s3.model.PutObjectRequest</code> and <code>software.amazon.awssdk.services.s3.model.UploadPartRequest</code>.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.dualstack"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.dualstack">quarkus.s3.dualstack</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable dualstack mode for accessing S3. If you want to use IPv6 when accessing S3, dualstack must be enabled.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.path-style-access"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.path-style-access">quarkus.s3.path-style-access</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable using path style access for accessing S3 objects instead of DNS style access. DNS style access is preferred as it will result in better load balancing when accessing S3.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.use-arn-region-enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.use-arn-region-enabled">quarkus.s3.use-arn-region-enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable cross-region call to the region specified in the S3 resource ARN different than the region the client was configured with. If this flag is not set to 'true', the cross-region call will throw an exception.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.profile-name"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.profile-name">quarkus.s3.profile-name</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Define the profile name that should be consulted to determine the default value of <code>use-arn-region-enabled</code>. This is not used, if the <code>use-arn-region-enabled</code> is configured to 'true'.
 If not specified, the value in <code>AWS_PROFILE</code> environment variable or <code>aws.profile</code> system property is used and defaults to <code>default</code> name.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.sdk"></a><a href="#quarkus-amazon-s3_quarkus.s3.sdk">AWS SDK client configurations</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.endpoint-override"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.endpoint-override">quarkus.s3.endpoint-override</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The endpoint URI with which the SDK should communicate.
 If not specified, an appropriate endpoint to be used for the given service and region.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/net/URI.html">URI</a></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.api-call-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.api-call-timeout">quarkus.s3.api-call-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to allow the client to complete the execution of an API call.
 This timeout covers the entire client execution except for marshalling. This includes request handler execution, all HTTP requests including retries, unmarshalling, etc.
 This value should always be positive, if present.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.api-call-attempt-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.api-call-attempt-timeout">quarkus.s3.api-call-attempt-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to wait for the HTTP request to complete before giving up and timing out.
 This value should always be positive, if present.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.aws"></a><a href="#quarkus-amazon-s3_quarkus.s3.aws">AWS services configurations</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.region"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.region">quarkus.s3.aws.region</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>An Amazon Web Services region that hosts the given service.</p>
</div>
<div class="paragraph">
<p>It overrides region provider chain with static value of
region with which the service client should communicate.</p>
</div>
<div class="paragraph">
<p>If not set, region is retrieved via the default providers chain in the following order:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>aws.region</code> system property</p>
</li>
<li>
<p><code>region</code> property from the profile file</p>
</li>
<li>
<p>Instance profile file</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>See <code>software.amazon.awssdk.regions.Region</code> for available regions.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">Region</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.type"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.type">quarkus.s3.aws.credentials.type</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Configure the credentials provider that should be used to authenticate with AWS.</p>
</div>
<div class="paragraph">
<p>Available values:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>default</code> - the provider will attempt to identify the credentials automatically using the following checks:</p>
<div class="ulist">
<ul>
<li>
<p>Java System Properties - <code>aws.accessKeyId</code> and <code>aws.secretKey</code></p>
</li>
<li>
<p>Environment Variables - <code>AWS_ACCESS_KEY_ID</code> and <code>AWS_SECRET_ACCESS_KEY</code></p>
</li>
<li>
<p>Credential profiles file at the default location (<code>~/.aws/credentials</code>) shared by all AWS SDKs and the AWS CLI</p>
</li>
<li>
<p>Credentials delivered through the Amazon EC2 container service if <code>AWS_CONTAINER_CREDENTIALS_RELATIVE_URI</code> environment variable is set and security manager has permission to access the variable.</p>
</li>
<li>
<p>Instance profile credentials delivered through the Amazon EC2 metadata service</p>
</li>
</ul>
</div>
</li>
<li>
<p><code>static</code> - the provider that uses the access key and secret access key specified in the <code>static-provider</code> section of the config.</p>
</li>
<li>
<p><code>system-property</code> - it loads credentials from the <code>aws.accessKeyId</code>, <code>aws.secretAccessKey</code> and <code>aws.sessionToken</code> system properties.</p>
</li>
<li>
<p><code>env-variable</code> - it loads credentials from the <code>AWS_ACCESS_KEY_ID</code>, <code>AWS_SECRET_ACCESS_KEY</code> and <code>AWS_SESSION_TOKEN</code> environment variables.</p>
</li>
<li>
<p><code>profile</code> - credentials are based on AWS configuration profiles. This loads credentials from
a <a href="http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html">profile file</a>,
allowing you to share multiple sets of AWS security credentials between different tools like the AWS SDK for Java and the AWS CLI.</p>
</li>
<li>
<p><code>container</code> - It loads credentials from a local metadata service. Containers currently supported by the AWS SDK are
<strong>Amazon Elastic Container Service (ECS)</strong> and <strong>AWS Greengrass</strong></p>
</li>
<li>
<p><code>instance-profile</code> - It loads credentials from the Amazon EC2 Instance Metadata Service.</p>
</li>
<li>
<p><code>process</code> - Credentials are loaded from an external process. This is used to support the credential_process setting in the profile
credentials file. See <a href="https://docs.aws.amazon.com/cli/latest/topic/config-vars.html#sourcing-credentials-from-external-processes">Sourcing Credentials From External Processes</a>
for more information.</p>
</li>
<li>
<p><code>anonymous</code> - It always returns anonymous AWS credentials. Anonymous AWS credentials result in un-authenticated requests and will
fail unless the resource or API&#8217;s policy has been configured to specifically allow anonymous access.</p>
</li>
</ul>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>default</code>, <code>static</code>, <code>system-property</code>, <code>env-variable</code>, <code>profile</code>, <code>container</code>, <code>instance-profile</code>, <code>process</code>, <code>anonymous</code></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>default</code></p></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.default-provider"></a><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.default-provider">Default credentials provider configuration</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.default-provider.async-credential-update-enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.default-provider.async-credential-update-enabled">quarkus.s3.aws.credentials.default-provider.async-credential-update-enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Whether this provider should fetch credentials asynchronously in the background.
 If this is <code>true</code>, threads are less likely to block, but additional resources are used to maintain the provider.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.default-provider.reuse-last-provider-enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.default-provider.reuse-last-provider-enabled">quarkus.s3.aws.credentials.default-provider.reuse-last-provider-enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Whether the provider should reuse the last successful credentials provider in the chain.
 Reusing the last successful credentials provider will typically return credentials faster than searching through the chain.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.static-provider"></a><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.static-provider">Static credentials provider configuration</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.static-provider.access-key-id"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.static-provider.access-key-id">quarkus.s3.aws.credentials.static-provider.access-key-id</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>AWS Access key id</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.static-provider.secret-access-key"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.static-provider.secret-access-key">quarkus.s3.aws.credentials.static-provider.secret-access-key</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>AWS Secret access key</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.profile-provider"></a><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.profile-provider">AWS Profile credentials provider configuration</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.profile-provider.profile-name"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.profile-provider.profile-name">quarkus.s3.aws.credentials.profile-provider.profile-name</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The name of the profile that should be used by this credentials provider.
 If not specified, the value in <code>AWS_PROFILE</code> environment variable or <code>aws.profile</code> system property is used and defaults to <code>default</code> name.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider"></a><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider">Process credentials provider configuration</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.async-credential-update-enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.async-credential-update-enabled">quarkus.s3.aws.credentials.process-provider.async-credential-update-enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Whether the provider should fetch credentials asynchronously in the background.
 If this is true, threads are less likely to block when credentials are loaded, but additional resources are used to maintain the provider.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.credential-refresh-threshold"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.credential-refresh-threshold">quarkus.s3.aws.credentials.process-provider.credential-refresh-threshold</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time between when the credentials expire and when the credentials should start to be refreshed.
 This allows the credentials to be refreshed *before* they are reported to expire.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>15S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.process-output-limit"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.process-output-limit">quarkus.s3.aws.credentials.process-provider.process-output-limit</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum size of the output that can be returned by the external process before an exception is raised.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">MemorySize  <a href="#memory-size-note-anchor" title="More information about the MemorySize format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>1024</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.command"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.aws.credentials.process-provider.command">quarkus.s3.aws.credentials.process-provider.command</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The command that should be executed to retrieve credentials.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.sync-client"></a><a href="#quarkus-amazon-s3_quarkus.s3.sync-client">Sync HTTP transport configurations</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.connection-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.connection-timeout">quarkus.s3.sync-client.connection-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum amount of time to establish a connection before timing out.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>2S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.socket-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.socket-timeout">quarkus.s3.sync-client.socket-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to wait for data to be transferred over an established, open connection before the connection is timed out.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>30S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.type"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.type">quarkus.s3.sync-client.tls-managers-provider.type</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>TLS managers provider type.</p>
</div>
<div class="paragraph">
<p>Available providers:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>none</code> - Use this provider if you don&#8217;t want the client to present any certificates to the remote TLS host.</p>
</li>
<li>
<p><code>system-property</code> - Provider checks the standard <code>javax.net.ssl.keyStore</code>, <code>javax.net.ssl.keyStorePassword</code>, and
<code>javax.net.ssl.keyStoreType</code> properties defined by the
 <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/JSSERefGuide.html">JSSE</a>.</p>
</li>
<li>
<p><code>file-store</code> - Provider that loads a the key store from a file.</p>
</li>
</ul>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>none</code>, <code>system-property</code>, <code>file-store</code></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>system-property</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.file-store.path"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.file-store.path">quarkus.s3.sync-client.tls-managers-provider.file-store.path</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Path to the key store.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">path</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.file-store.type"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.file-store.type">quarkus.s3.sync-client.tls-managers-provider.file-store.type</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Key store type.
 See the KeyStore section in the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#KeyStore[Java" class="bare">https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#KeyStore[Java</a> Cryptography Architecture Standard Algorithm Name Documentation] for information about standard keystore types.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.file-store.password"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.tls-managers-provider.file-store.password">quarkus.s3.sync-client.tls-managers-provider.file-store.password</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Key store password</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache"></a><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache">Apache HTTP client specific configurations</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.connection-acquisition-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.connection-acquisition-timeout">quarkus.s3.sync-client.apache.connection-acquisition-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to wait when acquiring a connection from the pool before giving up and timing out.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>10S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.connection-max-idle-time"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.connection-max-idle-time">quarkus.s3.sync-client.apache.connection-max-idle-time</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum amount of time that a connection should be allowed to remain open while idle.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>60S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.connection-time-to-live"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.connection-time-to-live">quarkus.s3.sync-client.apache.connection-time-to-live</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum amount of time that a connection should be allowed to remain open, regardless of usage frequency.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.max-connections"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.max-connections">quarkus.s3.sync-client.apache.max-connections</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum number of connections allowed in the connection pool.
 Each built HTTP client has its own private connection pool.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">int</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>50</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.expect-continue-enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.expect-continue-enabled">quarkus.s3.sync-client.apache.expect-continue-enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Whether the client should send an HTTP expect-continue handshake before each request.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.use-idle-connection-reaper"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.use-idle-connection-reaper">quarkus.s3.sync-client.apache.use-idle-connection-reaper</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Whether the idle connections in the connection pool should be closed asynchronously.
 When enabled, connections left idling for longer than <code>quarkus..sync-client.connection-max-idle-time</code> will be closed. This will not close connections currently in use.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.enabled">quarkus.s3.sync-client.apache.proxy.enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable HTTP proxy</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.endpoint"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.endpoint">quarkus.s3.sync-client.apache.proxy.endpoint</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The endpoint of the proxy server that the SDK should connect through.
 Currently, the endpoint is limited to a host and port. Any other URI components will result in an exception being raised.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/net/URI.html">URI</a></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.username"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.username">quarkus.s3.sync-client.apache.proxy.username</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The username to use when connecting through a proxy.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.password"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.password">quarkus.s3.sync-client.apache.proxy.password</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The password to use when connecting through a proxy.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.ntlm-domain"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.ntlm-domain">quarkus.s3.sync-client.apache.proxy.ntlm-domain</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>For NTLM proxies - the Windows domain name to use when authenticating with the proxy.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.ntlm-workstation"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.ntlm-workstation">quarkus.s3.sync-client.apache.proxy.ntlm-workstation</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>For NTLM proxies - the Windows workstation name to use when authenticating with the proxy.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.preemptive-basic-authentication-enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.preemptive-basic-authentication-enabled">quarkus.s3.sync-client.apache.proxy.preemptive-basic-authentication-enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Whether to attempt to authenticate preemptively against the proxy server using basic authentication.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.non-proxy-hosts"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.sync-client.apache.proxy.non-proxy-hosts">quarkus.s3.sync-client.apache.proxy.non-proxy-hosts</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The hosts that the client is allowed to access without going through the proxy.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">list of string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<th class="tableblock halign-left valign-top"><p class="tableblock"><a id="quarkus-amazon-s3_quarkus.s3.async-client"></a><a href="#quarkus-amazon-s3_quarkus.s3.async-client">Netty HTTP transport configurations</a></p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Type</p></th>
<th class="tableblock halign-left valign-middle"><p class="tableblock">Default</p></th>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.max-concurrency"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.max-concurrency">quarkus.s3.async-client.max-concurrency</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum number of allowed concurrent requests.
 For HTTP/1.1 this is the same as max connections. For HTTP/2 the number of connections that will be used depends on the max streams allowed per connection.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">int</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>50</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.max-pending-connection-acquires"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.max-pending-connection-acquires">quarkus.s3.async-client.max-pending-connection-acquires</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum number of pending acquires allowed.
 Once this exceeds, acquire tries will be failed.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">int</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>10000</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.read-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.read-timeout">quarkus.s3.async-client.read-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to wait for a read on a socket before an exception is thrown.
 Specify <code>0</code> to disable.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>30S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.write-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.write-timeout">quarkus.s3.async-client.write-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to wait for a write on a socket before an exception is thrown.
 Specify <code>0</code> to disable.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>30S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.connection-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.connection-timeout">quarkus.s3.async-client.connection-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to wait when initially establishing a connection before giving up and timing out.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>10S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.connection-acquisition-timeout"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.connection-acquisition-timeout">quarkus.s3.async-client.connection-acquisition-timeout</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The amount of time to wait when acquiring a connection from the pool before giving up and timing out.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>2S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.connection-time-to-live"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.connection-time-to-live">quarkus.s3.async-client.connection-time-to-live</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum amount of time that a connection should be allowed to remain open, regardless of usage frequency.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.connection-max-idle-time"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.connection-max-idle-time">quarkus.s3.async-client.connection-max-idle-time</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum amount of time that a connection should be allowed to remain open while idle.
 Currently has no effect if <code>quarkus..async-client.use-idle-connection-reaper</code> is false.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>60S</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.use-idle-connection-reaper"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.use-idle-connection-reaper">quarkus.s3.async-client.use-idle-connection-reaper</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Whether the idle connections in the connection pool should be closed.
 When enabled, connections left idling for longer than <code>quarkus..async-client.connection-max-idle-time</code> will be closed. This will not close connections currently in use.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.protocol"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.protocol">quarkus.s3.async-client.protocol</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The HTTP protocol to use.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>http1-1</code>, <code>http2</code></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>http1-1</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.ssl-provider"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.ssl-provider">quarkus.s3.async-client.ssl-provider</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The SSL Provider to be used in the Netty client.
 Default is <code>OPENSSL</code> if available, <code>JDK</code> otherwise.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>jdk</code>, <code>openssl</code>, <code>openssl-refcnt</code></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.http2.max-streams"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.http2.max-streams">quarkus.s3.async-client.http2.max-streams</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The maximum number of concurrent streams for an HTTP/2 connection.
 This setting is only respected when the HTTP/2 protocol is used.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">long</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>4294967295</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.http2.initial-window-size"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.http2.initial-window-size">quarkus.s3.async-client.http2.initial-window-size</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The initial window size for an HTTP/2 stream.
 This setting is only respected when the HTTP/2 protocol is used.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">int</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>1048576</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.http2.health-check-ping-period"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.http2.health-check-ping-period">quarkus.s3.async-client.http2.health-check-ping-period</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Sets the period that the Netty client will send <code>PING</code> frames to the remote endpoint to check the health of the connection. To disable this feature, set a duration of 0.
 This setting is only respected when the HTTP/2 protocol is used.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html">Duration</a>
  <a href="#duration-note-anchor" title="More information about the Duration format"><span class="icon"><i class="fa fa-question-circle"></i></span></a></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>5</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.proxy.enabled"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.proxy.enabled">quarkus.s3.async-client.proxy.enabled</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable HTTP proxy.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.proxy.endpoint"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.proxy.endpoint">quarkus.s3.async-client.proxy.endpoint</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The endpoint of the proxy server that the SDK should connect through.
 Currently, the endpoint is limited to a host and port. Any other URI components will result in an exception being raised.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><a href="https://docs.oracle.com/javase/8/docs/api/java/net/URI.html">URI</a></p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.proxy.non-proxy-hosts"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.proxy.non-proxy-hosts">quarkus.s3.async-client.proxy.non-proxy-hosts</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The hosts that the client is allowed to access without going through the proxy.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">list of string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.type"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.type">quarkus.s3.async-client.tls-managers-provider.type</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>TLS managers provider type.</p>
</div>
<div class="paragraph">
<p>Available providers:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>none</code> - Use this provider if you don&#8217;t want the client to present any certificates to the remote TLS host.</p>
</li>
<li>
<p><code>system-property</code> - Provider checks the standard <code>javax.net.ssl.keyStore</code>, <code>javax.net.ssl.keyStorePassword</code>, and
<code>javax.net.ssl.keyStoreType</code> properties defined by the
 <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/jsse/JSSERefGuide.html">JSSE</a>.</p>
</li>
<li>
<p><code>file-store</code> - Provider that loads a the key store from a file.</p>
</li>
</ul>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>none</code>, <code>system-property</code>, <code>file-store</code></p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>system-property</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.file-store.path"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.file-store.path">quarkus.s3.async-client.tls-managers-provider.file-store.path</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Path to the key store.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">path</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.file-store.type"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.file-store.type">quarkus.s3.async-client.tls-managers-provider.file-store.type</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Key store type.
 See the KeyStore section in the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#KeyStore[Java" class="bare">https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#KeyStore[Java</a> Cryptography Architecture Standard Algorithm Name Documentation] for information about standard keystore types.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.file-store.password"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.tls-managers-provider.file-store.password">quarkus.s3.async-client.tls-managers-provider.file-store.password</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Key store password</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.event-loop.override"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.event-loop.override">quarkus.s3.async-client.event-loop.override</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Enable the custom configuration of the Netty event loop group.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">boolean</p></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.event-loop.number-of-threads"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.event-loop.number-of-threads">quarkus.s3.async-client.event-loop.number-of-threads</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>Number of threads to use for the event loop group.
 If not set, the default Netty thread count is used (which is double the number of available processors unless the <code>io.netty.eventLoopThreads</code> system property is set.</p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">int</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a id="quarkus-amazon-s3_quarkus.s3.async-client.event-loop.thread-name-prefix"></a><code><a href="#quarkus-amazon-s3_quarkus.s3.async-client.event-loop.thread-name-prefix">quarkus.s3.async-client.event-loop.thread-name-prefix</a></code></p>
</div>
<div class="openblock description">
<div class="content">
<div class="paragraph">
<p>The thread name prefix for threads created by this thread factory used by event loop group.
 The prefix will be appended with a number unique to the thread factory and a number unique to the thread.
 If not specified it defaults to <code>aws-java-sdk-NettyEventLoop</code></p>
</div>
</div>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">string</p></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
</tbody>
</table>
<div id="duration-note-anchor" class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="title">About the Duration format</div>
<div class="paragraph">
<p>The format for durations uses the standard <code>java.time.Duration</code> format.
You can learn more about it in the <a href="https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html#parse-java.lang.CharSequence-">Duration#parse() javadoc</a>.</p>
</div>
<div class="paragraph">
<p>You can also provide duration values starting with a number.
In this case, if the value consists only of a number, the converter treats the value as seconds.
Otherwise, <code>PT</code> is implicitly prepended to the value to obtain a standard <code>java.time.Duration</code> format.</p>
</div>
</td>
</tr>
</table>
</div>
<div id="memory-size-note-anchor" class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="title">About the MemorySize format</div>
<div class="paragraph">
<p>A size configuration option recognises string in this format (shown as a regular expression): <code>[0-9]+[KkMmGgTtPpEeZzYy]?</code>.
If no suffix is given, assume bytes.</p>
</div>
</td>
</tr>
</table>
</div>
</div>
</div>
    </div>
  </div>
</div>

  </div>

  <div class="content project-footer">
  <div class="footer-section">
    <div class="logo-wrapper">
      <a href="/"><img src="/assets/images/quarkus_logo_horizontal_rgb_reverse.svg" class="project-logo" title="Quarkus"></a>
    </div>
  </div>
  <div class="grid-wrapper">
    <p class="grid__item width-3-12">Quarkus is open. All dependencies of this project are available under the <a href='https://www.apache.org/licenses/LICENSE-2.0' target='_blank'>Apache Software License 2.0</a> or compatible license.<br /><br />This website was built with <a href='https://jekyllrb.com/' target='_blank'>Jekyll</a>, is hosted on <a href='https://pages.github.com/' target='_blank'>Github Pages</a> and is completely open source. If you want to make it better, <a href='https://github.com/quarkusio/quarkusio.github.io' target='_blank'>fork the website</a> and show us what you’ve got.</p>

    
      <div class="width-1-12 project-links">
        <span>Navigation</span>
        <ul class="footer-links width-1-12">
          
            <li><a href="/">Home</a></li>
          
            <li><a href="/guides">Guides</a></li>
          
            <li><a href="/community/#contributing">Contribute</a></li>
          
            <li><a href="/faq">FAQ</a></li>
          
            <li><a href="/get-started">Get Started</a></li>
          
        </ul>
      </div>
    
      <div class="width-1-12 project-links">
        <span>Contribute</span>
        <ul class="footer-links width-1-12">
          
            <li><a href="https://twitter.com/quarkusio">Follow us</a></li>
          
            <li><a href="https://github.com/quarkusio">GitHub</a></li>
          
            <li><a href="/security">Security&nbsp;policy</a></li>
          
        </ul>
      </div>
    
      <div class="width-1-12 project-links">
        <span>Get Help</span>
        <ul class="footer-links width-1-12">
          
            <li><a href="https://groups.google.com/forum/#!forum/quarkus-dev">Forums</a></li>
          
            <li><a href="https://quarkusio.zulipchat.com">Chatroom</a></li>
          
        </ul>
      </div>
    

    
      <div class="width-3-12 more-links">
        <span>Quarkus is made of community projects</span>
        <ul class="footer-links">
          
            <li><a href="https://vertx.io/" target="_blank">Eclipse Vert.x</a></li>
          
            <li><a href="https://microprofile.io" target="_blank">Eclipse MicroProfile</a></li>
          
            <li><a href="https://hibernate.org" target="_blank">Hibernate</a></li>
          
            <li><a href="https://netty.io" target="_blank">Netty</a></li>
          
            <li><a href="https://resteasy.github.io" target="_blank">RESTEasy</a></li>
          
            <li><a href="https://camel.apache.org" target="_blank">Apache Camel</a></li>
          
            <li><a href="https://code.quarkus.io/" target="_blank">And many more...</a></li>
          
        </ul>
      </div>
    
  </div>
</div>
  <div class="content redhat-footer">
  <div class="grid-wrapper">
    <span class="licence">
      <i class="fab fa-creative-commons"></i><i class="fab fa-creative-commons-by"></i> <a href="https://creativecommons.org/licenses/by/3.0/" target="_blank">CC by 3.0</a> | <a href="https://www.redhat.com/en/about/privacy-policy">Privacy Policy</a>
    </span>
    <span class="redhat">
      Sponsored by
    </span>
    <span class="redhat-logo">
      <a href="https://www.redhat.com/" target="_blank"><img src="/assets/images/redhat_reversed.svg"></a>
    </span>
  </div>
</div>


  <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.4/jquery.min.js" integrity="sha384-8gBf6Y4YYq7Jx97PIqmTwLPin4hxIzQw5aDmUg/DDhul9fFpbbLcLh3nTIIDJKhx" crossorigin="anonymous"></script>
  <script type="text/javascript" src="/assets/javascript/mobile-nav.js"></script>
  <script type="text/javascript" src="/assets/javascript/scroll-down.js"></script>
  <script src="/assets/javascript/satellite.js" type="text/javascript"></script>
  <script src="https://quarkus.io/guides/javascript/config.js" type="text/javascript"></script>
  <script src="/assets/javascript/search-filter.js" type="text/javascript"></script>
  <script src="/assets/javascript/back-to-top.js" type="text/javascript"></script>
</body>

</html>
